home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 41.zip / BS1 part 41 / BASICS compilation.adf / README.GFA (.txt) < prev    next >
GFA-BASIC Amiga  |  1989-03-06  |  7KB  |  129 lines
  1. GFA-AMIGAB
  2. EXAMPLES
  3. Readme GFA-Basic 3.02 AMIGA 7.2.1989
  4. The Run-Only-Interpreteter
  5. --------------------------
  6. The Run-Only-Interpreter GFABASRO is Public Domain.
  7. To start your GFA-Basic program with the Run-Only from Workbench,
  8. single click it's icon. Then select "INFO" from the Workbenchmenu
  9. and change the TOOL (GFABASIC) to GFABASRO.
  10. BOBs-Blitter Objects
  11. --------------------
  12. Blitter object's are a special kind of sprites. You can create them
  13. with the Amiga-Objecteditor. Further you can use the program
  14. "IFF TO BOB" to build an Bob.
  15. commands:
  16.       OBJECT.AX    object,value
  17.       OBJECT.AY    object,value
  18.         defines the acceleration of the Bob (pixels/sec)
  19.       OBJECT.CLIP  x0,y0,x1,y1
  20.         defines a frame where the Bobs are visible
  21.       OBJECT.CLOSE [Obj [,Obj [,Obj ] ] ]
  22.         erase Object[s]
  23.         without parameters all objects are erased
  24.       OBJECT.ON    [Obj [,Obj [Obj ] ] ]
  25.       OBJECT.OFF    "     "    "
  26.         Obj : 16 Bit object-number
  27.         switches an object.
  28.         without parameters all objects are switched on/off
  29.       OBJECT.PLANES Obj [PlanePick [,PlaneOnOff ] ]
  30.         PlanePick, PlaneOnOff : 8-Bit-Masks
  31.         OBJECT.PLANES fixes the Bob's color.
  32.         PlanePick defines the bitplane in which the BobInfos
  33.         are painted. PlaneOnOff defines the used bitplanes.
  34.       OBJECT.PRIORITY Obj,Prio
  35.         Bobs with a higher priority are set in front of bobs
  36.         with a lower priority.
  37.       OBECT.SHAPE Obj,String
  38.       OBECT.SHAPE Obj1,Obj2
  39.         (1) The definition for Bob number <Obj> is given
  40.             by a String from the Object-Editor or
  41.             the "IFF_TO_BOB" program.
  42.         (2) Obj1 uses the shape of Obj2.
  43.       OBJECT.START [Obj [,Obj [,Obj ] ] ]
  44.       OBJECT.STOP    "     "     "
  45.          Start and stop of Bobs-movements.
  46.          All objects are stopped or started if there
  47.          are no parameters.
  48.       OBJECT.VX    Obj,Value
  49.       OBJECT.VY     "    "
  50.          defines the speed of an object in pixels per sec.
  51.       OBJECT.X     Obj,Value
  52.       OBJECT.X      "    "
  53.          set object number Obj at ValueX/ValueY
  54.          Don't forget using the OBJECT.ON command to
  55.          make the Bob[s] visible.
  56.       ON COLLISION GOSUB proc
  57.         proc: Procedure's name to react on collision
  58.       Object-Functions:
  59.       use
  60.       ...=OBJECT.X(Obj)
  61.          =OBJECT.Y(Obj)
  62.          =OBJECT.VX(Obj)
  63.          =OBJECT.VY(Obj)
  64.          =OBJECT.AX(Obj)
  65.          =OBJECT.AY(Obj)
  66.       to read the position, acceleration or the speed
  67.       of the specified Object.
  68.       The GFA Bob-commands work similar to the AmigaBasic
  69.       Object-commands except for:.
  70.         - Collision ON/OFF/STOP is not possible
  71.         - ...=COLLISION(-1) does not give number of the window
  72. E D I T O R   M E N U :
  73. -----------------------
  74.       LOAD      Amiga-L  as F1
  75.       SAVE      Amiga-S  as shift-F1
  76.       New Names Amiga-N  ask for confirmation when new variables are
  77.                          introduced (switch)
  78.       RUN       Amiga-R  as Shift-F10
  79.       Taskpri 0 Amiga-0  Changes taskpriority to 0.
  80.       Taskpri 1 Amiga-1  Changes taskpriority to 1.
  81.                          Use ~SetTaskPri(FindTask(0),n) to set other
  82.                          taskpriorities.
  83.       Clenup    Amiga-C  Stop Sound, stop Bobs and clear Sprites
  84.                          Closes Screens and Windows.
  85.       NewCli             starts a new CLI
  86.       Icon      Amiga-I  Save program with Icon or without
  87. N E W  C O M M A N D S:
  88. ----------------------
  89. The following command are added:
  90.   OPEN "_",#_,"COM1:[BAUDRATE [,PARITY [,LENGTH [,STOPBITS]]]]"
  91.   with: BAUDRATE: 110/150/300/600/1200/1800/2400/4800/9600/19200
  92.         PARITY:   "N" (no parity), "O" (odd) or "E" (even parity).
  93.         LENGTH: the number of bits (5 to 8)
  94.         STOPBITS: the number of stopbits to use (1 or 2)
  95.   This command is used as in AmigaBasic. It opens a file for Input
  96.   or Output to the serial port, and allows to configure the serial port.
  97.   examples:
  98.   OPEN "I",#1,"COM1:9600,N,7,1" opens for input, sets the serial port
  99.            to 9600 Baud, No parity, 7 bits with 1 stopbit.
  100.   OPEN"O",#1,"COM1:300,O,6,1" opens for output, sets the serial port
  101.            to 300 Baud, Odd parity, 6 bits and 1 stopbit.
  102.   OPEN"O",#1,"COM1:600" leaves all paramters unchanged except for the
  103.            baudrate.
  104. - GET/PUT now use clipping
  105. - SGET $()/SPUT $() : They do the same as the SGET string /
  106.   SPUT string -commands on the ST, except that they use a string-ARRAY
  107.   instead of a string (On the Amiga a screen can use more than 32K).
  108.   They work on screen: they take (or put) the contents of a whole screen.
  109. - SCROLL dx,dy,x0,y0,x1,y1 scrolls a rectangle in your window.
  110.   i.e.: SCROLL 2,3,10,10,100,100  scrolls the rectangle (10,10)-(100,100)
  111.   two pixels to the right, 3 pixels down, and the second parameter of
  112.   COLOR determines the color of the borders that are scrolled in (here left
  113.   and upper border of the rectangle).
  114. - Now GFABASIC also saves an Icon with your sources if you want it to.
  115.   Therefore, the pull-down menu got an extra selection called "Save Icon",
  116.   shortcut is "Right_Amiga_Key + I". Use this to turn this icon-save-option
  117.   on or off.
  118. F O R ... N E X T
  119. -----------------
  120. FOR ...  NEXT loops are now not executed if the start value is not already
  121. greater than the endvalue.
  122. The following loops give similar results:
  123. FOR NEXT                 GFA-Basic V3.00      GFA-Basic V3.02
  124. FOR i=a TO b             i=a                  i=a
  125.  ...                     REPEAT               WHILE i<b
  126.                           ...                  ...
  127.                           INC i                INC i
  128. NEXT i                   UNTIL i>b            WEND
  129.